home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / zdbench.zip / DATABASE.TXT < prev    next >
Text File  |  1992-07-13  |  4KB  |  115 lines
  1. Database functions - Bench 1.1
  2. ------------------------------
  3.  
  4.      Hidden underneath Bench 1.1 is a dBASE-compatible
  5. database engine (Codebase ++, by Sequiter Software).  This
  6. database engine is responsible not only for cataloging
  7. the tests, but also for keeping track of their results.  In
  8. order for you to get the most out of Bench 1.1, it is
  9. important to understand how Bench 1.1 organizes
  10. the results it generates from the tests.
  11.  
  12.      In the Bench subdirectory, you will find five .DBF
  13. files and five .MDX files:
  14.  
  15.           TEST.DBF       TEST.MDX
  16.           TSTGROUP.DBF   TSTGROUP.MDX
  17.           MACHINE.DBF    MACHINE.MDX
  18.           RESULT.DBF     RESULT.MDX
  19.           SYSINFO.DBF    SYSINFO.MDX
  20.  
  21.      The .DBF files are dBASE-compatible data files and the
  22. .MDX files are their respective index files.  The MACHINE and 
  23. RESULT files record information for the test machines.
  24.  
  25.      The MACHINE file stores data about a given system
  26. configuration.  The information in this file is as
  27. follows:
  28.  
  29.           Machine ID          :    8 characters
  30.           Variant             :    1 character
  31.           Machine Name        :    12 characters
  32.           Machine Description :    225 characters
  33.  
  34.      The Machine ID and Variant are used to uniquely
  35. identify a machine and configuration.  For example:
  36.  
  37.           Machine ID: ibm70        Variant: 0
  38.  
  39. could be used to identify an IBM PS/2 Model 70 configured to
  40. run without a disk cache while:
  41.  
  42.           Machine ID: ibm70        Variant: 1
  43.  
  44. could be used to identify the same machine with disk caching
  45. enabled.
  46.  
  47.      It is imperative to use meaningful Machine IDs when
  48. recording test results.  
  49.  
  50.      When printing test results to a file, the output
  51. file name will take the form of:
  52.  
  53.                     [MachineID].PR[V]
  54.  
  55.      where [V] is the Variant ID used for that unit's test
  56. run.
  57.  
  58.      "Machine Name" serves in Bench 1.1 as identifier for
  59. column headings in all of the test windows.
  60.  
  61.      Machine Description is a long description which can
  62. include notes about the system's components, any special
  63. configuration notes, or any special observations about the
  64. system's behavior while under test.
  65.  
  66.      The RESULT file is where all the results from the tests
  67. are stored.  Provided with Bench 1.1 are result files from the
  68. following machines:
  69.  
  70.      IBM XT                        IBM AT
  71.      Compaq Deskpro 386N           IBM Model 70-A21
  72.      Compaq Deskpro 38625e         IBM Model 90 (486-33)
  73.  
  74.      Every time a test is run, the result is immediately
  75. written to the database.  This ensures that if there is a
  76. problem with any one test hanging the system or aborting the
  77. tests, the results from the rest of the test run aren't
  78. lost.  Upon exiting the program, the exit dialog box asks you
  79. if you want to commit results to the database.  Checking this
  80. box means that the results that are currently in the
  81. database will be permanently stamped with a date and
  82. time.  This will permit these results to be recalled later on
  83. for comparison purposes.
  84.  
  85.      If you choose not to commit the results to the
  86. database, the next time you run the program, the first thing
  87. that will appear is a dialog that will remind you of
  88. uncommitted results in the database.  You will be given four
  89. options at that time:
  90.  
  91.      use - use the results and bring them back
  92. for modifications/additions
  93.  
  94.      delete - delete the results from the
  95. database and then prompt for new machine information
  96.  
  97.      commit - date- and time-stamp the results
  98. and then prompt for new machine information
  99.  
  100.      exit - exit the program
  101.  
  102. You should make backups of your database periodically.  In
  103. the event that your database becomes corrupt or gets
  104. destroyed there are backup files containing only the
  105. default comparison machine data.  When making
  106. your own backups, do not use the extensions .BKD or .BKX as
  107. they will conflict with the prestored backups.
  108.  
  109. TO RESTORE THE DATABASE TO ITS ORIGINAL CONTENTS:
  110. Run the REINITDB batch file.  You will be warned that your
  111. data is about to be destroyed.  To cancel the procedure, hold
  112. down the Ctrl key and hit the Break key.  (The word "Break"
  113. may appear on the front of this key on some keyboards.)
  114. 
  115.